Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movies and Your Event Loop

PtInTrack

The PtInTrack function allows your application to determine whether a specified point lies in the region defined by a track's display boundary region after it has been clipped by the movie's final display clipping region. This function is accurate at the current movie time.

pascal Boolean PtInTrack (Track theTrack, Point pt);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

pt

Specifies the point to be checked. This point must be expressed in the local display coordinate system of the movie that contains the track.

DESCRIPTION

The PtInTrack function returns a Boolean value. The function sets this value to true if the point lies in the track's display space.

SPECIAL CONSIDERATIONS

The region that PtInTrack checks for is different from the movie box.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

To find out if a point lies within the region defined by a movie's final display boundary region after it has been clipped by the movie's display clipping region, you can use the PtInMovie function, which is described in the previous section.